home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu559.dms / pu559.adf / Docs / ImageStudio.txt < prev    next >
Text File  |  1994-09-16  |  64KB  |  1,910 lines
  1. ImageStudio, shareware image processing and conversion package for the
  2. Amiga.
  3.  
  4.    Copyright (C) 1994 Andy Dean, Graham Dean.
  5.  
  6.    Welcome to ImageStudio, shareware image processing and conversion
  7. package for the Amiga.
  8.  
  9.    This document applies to version 1.0.1, written on 16th September
  10. 1994, Copyright (C) 1994 Andy Dean, Graham Dean.
  11.  
  12. Introduction
  13. ************
  14.  
  15.    This chapter gives a brief introduction into the features offered by
  16. the program.
  17.  
  18. Copyright and Disclaimer
  19. ========================
  20.  
  21.    No guarantee of any kind is given that the programs described in
  22. this document are 100% reliable. You are using this material at your
  23. own risk. The authors *can not* be made responsible for any damage
  24. which is caused by using this program.
  25.  
  26.    The unregistered package is freeware, but still copyright by Andy
  27. Dean and Graham Dean. This means that you can copy it freely as long as
  28. you don't ask for a more than nominal copying fee.
  29.  
  30.    The registered version of the program *may not* be freely
  31. distributed.
  32.  
  33.    Permission is granted to include the unregistered package in
  34. Public-Domain collections, especially in the excellent Fred Fish Amiga
  35. Disk Library (including CD ROM versions of it). The distribution file
  36. may be uploaded to Bulletin Board Systems or FTP servers. If you want
  37. to distribute this program you must use the original distribution
  38. archive ImageStudio.lha.
  39.  
  40.    This program (or parts of it) may not be included or used in
  41. commercial programs unless by written permission from the authors.
  42.  
  43. Machine requirements
  44. ====================
  45.  
  46.    ImageStudio requires the following system to run:
  47.  
  48.    * Workbench 2.04 or above.
  49.  
  50.    * Around 1 megabyte of free memory.
  51.  
  52.    * Several megabytes of free hard disk space.
  53.  
  54.    If ImageStudio is run on an AGA machine (A1200 or A4000), it will
  55. use the new display modes and palette routines to improve the quality
  56. of the internal viewer images.
  57.  
  58. Brief description
  59. =================
  60.  
  61.    ImageStudio is written for the casual graphics user who wishes to
  62. convert or manipulate various graphics formats on a modest Amiga
  63. system. There are several commercial offerings available, however the
  64. casual user is paying a lot of money for many facilities and options
  65. they would probably never use.
  66.  
  67.    Bitmap graphics, by their nature, usually require large amounts of
  68. RAM. One of the main objectives of ImageStudio was to reduce this
  69. burden by utilising virtual memory - most users have more spare hard
  70. disk space than spare RAM.
  71.  
  72.    ImageStudio works with several buffers at any one time (dependant on
  73. how many levels of undo are specified), each of these buffers can hold
  74. either colour-mapped or 24-bit images. For a detailed description of
  75. colour-mapped and 24-bit images, See Image types.
  76.  
  77. List of features
  78. ================
  79.  
  80.    General:
  81.    * Full 24-bit image buffers, with optimizations for colour-mapped
  82.      (palette based) images.
  83.  
  84.    * Up to 100 levels of undo / redo.
  85.  
  86.    * User configurable virtual memory.
  87.  
  88.    * User saveable preferences.
  89.  
  90.    * Operations applicable to the whole image or a selected region.
  91.  
  92.    * Up to 256 greyshade preview window (with optional dither).
  93.  
  94.    * Zoom on preview window.
  95.  
  96.    * Internal / external viewers (external for 3rd party 24-bit
  97.      graphics cards).
  98.  
  99.    * Loading / saving / manipulating of AGA image formats (e.g. 256
  100.      colours, HAM8) on non-AGA machines.
  101.  
  102.    * Max image size of 32000 x 32000 (limited to 250 x 250 in the
  103.      unregistered version).
  104.  
  105.    * Copy / paste to / from the system clipboard.
  106.  
  107.    * Runs on all Workbench 2.04+ Amiga's - utilises AGA chipset if
  108.      available.
  109.  
  110.    * On disk AmigaGuide and ASCII text documentation.
  111.  
  112.    * Multi-level help error requesters.
  113.  
  114.    * Standard Workbench2 interface.
  115.  
  116.    * Public screen.
  117.  
  118.    * Requires no third party libraries or utilities.
  119.  
  120.    Import:
  121.    * IFF-ILBM formats (Standard palette based, HAM6, HAM8, extra
  122.      halfbright, ILBM24)
  123.  
  124.    * BMP
  125.  
  126.    * GIF (conforming to GIF87a)
  127.  
  128.    * JPEG (conforming to JFIF standard)
  129.  
  130.    * PCX
  131.  
  132.    * Targa
  133.  
  134.    * Any installed Amiga datatype (with Workbench 2.1+)
  135.  
  136.    Export:
  137.    * IFF-ILBM formats (Standard palette based, HAM6, HAM8, extra
  138.      halfbright, ILBM24)
  139.  
  140.    * BMP
  141.  
  142.    * GIF (conforming to GIF87a)
  143.  
  144.    * JPEG (conforming to JFIF standard)
  145.  
  146.    * PCX
  147.  
  148.    * Targa
  149.  
  150.    Colour Balance:
  151.    * All operations are available to the R,G,B components separately.
  152.  
  153.    * Brightness ( upto ±100%)
  154.  
  155.    * Contrast (non to full)
  156.  
  157.    * Gamma ( + and - )
  158.  
  159.    Convolution:
  160.    * Built in convolutions: Blur, Sharpen, Emboss, Raise, Edge detect.
  161.  
  162.    * User definable convolutions, load and save to disk.
  163.  
  164.    Effects:
  165.    * Built in effects: FlipX, FlipY, RollX, RollY, Negative, Greyscale,
  166.      Highlight, Shadow, Random, Pixelize, Remove isolated pixels.
  167.  
  168.    Scale:
  169.    * Crop to selected region.
  170.  
  171.    * Increase / decrease scale by percentage or absolute image size.
  172.  
  173.    * Simple scale or colour averaged.
  174.  
  175.    Colour reduction:
  176.    * Increase colour mapped images to 24-bit.
  177.  
  178.    * Decrease number of colours in 24-bit or colour mapped images via
  179.      Heckbert median cut algorithm. Reduce to any number of colours
  180.      2-256 (not limited to powers of 2).
  181.  
  182.    * Methods of palette colour choice: Colour distance, highest count
  183.      and weighted average.
  184.  
  185.    * Dithers available for colour reduction: None, Floyd-Steinberg,
  186.      Burkes, Stucki, Sierra, Jarvis, Stevenson-Arce.
  187.  
  188.    Palette:
  189.    * Save current palette.
  190.  
  191.    * Force palette onto current image, dithering if necessary (all
  192.      dithers available).
  193.  
  194. Shareware version
  195. =================
  196.  
  197.    To encourage users to register, the freely distributable version of
  198. ImageStudio is limited to loading in pictures upto 250x250 pixels. All
  199. other operations are available.
  200.  
  201.    For details on how to register, See How to register.
  202.  
  203. Starting ImageStudio
  204. ====================
  205.  
  206.    ImageStudio can be started from either the Workbench or CLI. From
  207. the Workbench it is simply a case of double-clicking on the icon.
  208. ImageStudio supports shift-clicking on a file to start the program with
  209. (see the Workbench manual for more information).
  210.  
  211.    To start ImageStudio from the CLI, simply type:
  212.  
  213.      run ImageStudio [filename]
  214.  
  215.    where `filename' is an optional file to load in at startup. The full
  216. range of tooltypes is supported, and can be appended to the CLI
  217. command. For example:
  218.  
  219.      run ImageStudio "SCREENNAME=Image2" "PREVIEWDITHER=YES" [filename]
  220.  
  221.    would start the program on a public screen named `Image2' with
  222. preview dithering on. See Tooltypes, for a full list of available
  223. tooltypes.
  224.  
  225.    *If you are running ImageStudio from the CLI it is recommended that
  226. the stack be set to 40k*. To do this, type:
  227.  
  228.      stack 40000
  229.  
  230.    before running the program. This is not necessary if running
  231. ImageStudio from the Workbench, as the stack value is set in the
  232. program's icon.
  233.  
  234. Configuring ImageStudio
  235. =======================
  236.  
  237.    In order to benefit from ImageStudio's virtual memory, it is
  238. recommended that the default location used for the storage of the
  239. temporary files is changed. The default location for the storage of
  240. these files is `T:' which is usually in RAM - we want to move this out
  241. onto harddisk.
  242.  
  243.    To do this, select `Prefs' from the `Project' menu and open up the
  244. prefs requester. In the `Temp. files' string gadget, type the new
  245. location for the temp files.
  246.  
  247.    It is suggested that a drawer be made on a harddisk partition with
  248. lots of space to store these files. For example, make a drawer in your
  249. `Work:' partition called `tmp', and change the `Temp. files' string
  250. gadget to read `Work:tmp'.
  251.  
  252. Tutorial
  253. ********
  254.  
  255.    This chapter introduces ImageStudio by way of a few tutorials
  256. demonstrating commonly performed operations.
  257.  
  258. Changing the image format
  259. =========================
  260.  
  261.    The simplest use of ImageStudio is just as a file format converter;
  262. See File formats, for details about the supported file formats.
  263.  
  264.    In this example we will change the image format of the
  265. `FW14B_250x250.gif' from GIF to IFF-ILBM.
  266.  
  267.   1. Load the file `FW14B_250x250.gif' from the `Pics' drawer. To do
  268.      this, select `Open' from the `Project' menu. When the file
  269.      requester opens, select the file and it will load into
  270.      ImageStudio. The greyscale preview will show the image.
  271.  
  272.   2. The Infobar at the bottom of the screen shows the current image
  273.      size and number of colours, as well as a fuelgauge showing
  274.      progress when applicable. The current co-ordinates of the pointer
  275.      are also shown when the preview window is active.
  276.  
  277.   3. Open the save requester. To do this, select `Save' from the
  278.      `Project' menu. A requester will open, containing (amongst other
  279.      things) possible save formats.
  280.  
  281.   4. Select the file format to save. To do this, click on `IFF-ILBM' in
  282.      the listview.
  283.  
  284.   5. Change the filename to avoid overwriting the original file. To do
  285.      this, type the new filename - `FW14B_250x250.ilbm' into the
  286.      `Filename' string gadget.
  287.  
  288.   6. Save out the file by clicking on the `Save' gadget.
  289.  
  290.    The file will now be saved out as a 256 colour IFF-ILBM onto the
  291. disk.
  292.  
  293.    Note:
  294.  
  295.    * ImageStudio automatically recognises the filetype of the incoming
  296.      image. It will use its internal loaders first, then trying
  297.      datatypes if running on Workbench 2.1+.
  298.  
  299.    * All time consuming operations show their progress in the Infobar's
  300.      fuelgauge and can be aborted by clicking on the `Abort' gadget.
  301.  
  302. Changing the number of colours
  303. ==============================
  304.  
  305.    Often it is necessary to reduce the number of colours in an image,
  306. either to reduce the file size or produce images compatible with
  307. non-AGA software.
  308.  
  309.    In this example we will reduce the number of colours in the
  310. `FW14B_250x250.gif' image from 256 colours to 16 colours.
  311.  
  312.   1. Load in the `FW14B_250x250.gif' from the `Pics' drawer, if it not
  313.      already loaded.
  314.  
  315.   2. Open the colours requester by selecting `Colours...' from the
  316.      `Process' menu.
  317.  
  318.   3. The gadgets in the requester will show that the image is a 256
  319.      colour colour-mapped image. Change the number of colours to 16 by
  320.      clicking on the cycle gadget or sliding the `No. of colours'
  321.      slider.
  322.  
  323.   4. Leave the `Colour choice' and `Dithering' gadgets for now.
  324.  
  325.   5. Click on `OK' to perform the operation.
  326.  
  327.   6. When the operation is complete, view the image with the internal
  328.      viewer by selecting `View' from the `View' menu. A 16 colour Lores
  329.      image will be displayed.
  330.  
  331.   7. Remove the internal viewer by clicking the right mouse button.
  332.  
  333.    The colour reduced image should contain all the main colours used in
  334. the original image (blue, yellow, red and grey), but should contain
  335. less shades of the colours. To give the impression of more colours,
  336. dithering can be used to mix pixels of the chosen colours. To perform
  337. the last operation with dithering:
  338.  
  339.   1. Undo the colour reduction operation to return to the original 256
  340.      colour image. To do this, select `Undo' from the `Edit' menu.
  341.  
  342.   2. Bring up the colours requester as before and select 16 colours.
  343.      Also change the `Dithering' gadget from `None' to
  344.      `Floyd-Steinberg'.
  345.  
  346.   3. Click on `OK' to perform the operation.
  347.  
  348.   4. View as before.
  349.  
  350.    The image will now perform more gradual changes to colour changes.
  351.  
  352.    When ImageStudio is choosing which 16 colours to choose for the
  353. image, it uses either `Colour distance', `Highest count' or `Weighted
  354. average' methods of colour choice. Try performing the above dithered
  355. example, but also change to `Colour choice' to `Highest count'. This
  356. leads to a less colourful image, but perhaps with less contrast.
  357.  
  358.    There is no hard and fast rule as to which dither or colour choice
  359. is best for which image - it depends on the image and the number of
  360. colours you are reducing it to. ImageStudio gives you the options to
  361. experiment to see which method is best.
  362.  
  363. Changing the colour balance
  364. ===========================
  365.  
  366.    When receiving images from external sources (scanners, frame
  367. grabbers) it is ofter necessary to change to "colour balance" of the
  368. image. Frame grabbers, for example, may have too much `red' in the
  369. image.
  370.  
  371.    In this example we shall see the effects on the
  372. `ColourFace_200x250RED.ham6' image of altering the colour balance.
  373.  
  374.   1. Load in the `ColourFace_200x250RED.ham6' image from the `Pics'
  375.      drawer. As the file is in HAM6 format, it is turned into 24-bit
  376.      internally.
  377.  
  378.   2. View the image with the internal viewer. As the Amiga doesn't have
  379.      true 24-bit screenmodes, the internal viewer will approximate the
  380.      24-bit image with a HAM preview screen (HAM6 on ECS machines, HAM8
  381.      on AGA machines). It should be obvious from the viewer that the
  382.      image is too red.
  383.  
  384.   3. Open the balance floating palette if it is not already open. Do
  385.      this by selecting `Show balance' from the `Tools' menu.
  386.  
  387.   4. To remove some of the red component, make sure that we are only
  388.      dealing with the red component. To do this, make sure that only
  389.      the `Red' checkbox at the bottom of the floating palette is
  390.      checked.
  391.  
  392.   5. Reduce the brightness slider, by say 20%. The graph on the right
  393.      of the floating palette will reflect the change (see Show balance
  394.      for more details on the graph).
  395.  
  396.   6. View the image again, this time the image should have lost much of
  397.      its unnatural red tint.
  398.  
  399.    Brightness and contrast work in very much the same way as a TV set,
  400. but gamma may need some explanation.
  401.  
  402.    The printing an image out, it is usual for light colours to be
  403. resolved well and dark colours to be reduced to a dark mush. It is
  404. therefore preferable to have some way boost the brightness of the
  405. mid-dark colours whilst still leaving the very light colours light and
  406. the very dark colours dark. Gamma is the operator to perform this
  407. change. By applying a small amount of positive gamma, a much better
  408. balanced image can be produced for printing out.
  409.  
  410.    See Show balance, for more information on the balance floating
  411. palette.
  412.  
  413. Applying an effect
  414. ==================
  415.  
  416.    ImageStudio has many built in effects for performing commonly used
  417. operations.
  418.  
  419.    This example will remove some noise from a region of
  420. `HappyFace_240x250.bmp', a simulated scanned image.
  421.  
  422.   1. Load in the `HappyFace_240x250.bmp' image from the `Pics' drawer.
  423.  
  424.   2. The image represents what may happen if you hand scan an image
  425.      into the computer - lots of "noise".
  426.  
  427.   3. Open the effects floating palette if it is not already open. Do
  428.      this by selecting `Show effects' from the `Tools' menu.
  429.  
  430.   4. Select `Remove isolated pixels' in the listview of the floating
  431.      palette. If you clicked on the `Apply' button now, the effect
  432.      would be applied to the whole image. To compare the image before
  433.      and after the effect, we'll only apply the effect to the left hand
  434.      side of the image.
  435.  
  436.   5. Open the `Region co-ords' requester by selecting `Region
  437.      co-ords...' from the `Edit' menu. To select the left hand side of
  438.      the image, set the following values in the gadgets: Min x = 0, Min
  439.      y = 0, Width = 120, Height = 250. Make sure that the radio button
  440.      on the left of the requester shows that the Width / Height are
  441.      being used, not the Max values; click on `Ok'.
  442.  
  443.   6. A region of "crawling ants" will show the selected region.
  444.  
  445.   7. Click on `Apply' of the effects floating palette. The `Remove
  446.      isolated pixels' effect will be applied to the selected region.
  447.  
  448.   8. The left of the image will have had a lot of the noise
  449.      automatically removed. Clear the selected region by clicking in
  450.      the preview window.
  451.  
  452.    Note:
  453.    * Not all effects can be applied to regions and whole images. See
  454.      Show effects, for a comprehensive description of all the effects.
  455.  
  456.    See Show effects, for more information on the effects floating
  457. palette.
  458.  
  459. Applying a convolution
  460. ======================
  461.  
  462.    Convolution is a powerful image processing tool, ImageStudio allows
  463. the user to define their own convolution filters.
  464.  
  465.    This example will apply a `Texture' filter to the
  466. `CheetahFace_250x200.ilbm' image.
  467.  
  468.   1. Load in the `CheetahFace_250x200.ilbm' image from the `Pics'
  469.      drawer.
  470.  
  471.   2. The `CheetahFace_250x200.ilbm' image is a 32 colour colour-mapped
  472.      image and convolution only works in 24-bit (see Show convolves for
  473.      information on how convolves actually work). We therefore need to
  474.      turn the image into a 24-bit.
  475.  
  476.   3. Open the colours requester and click on the `16 million colours'
  477.      radio button on the left. Click on `OK'. The image in converted
  478.      into 24-bit.
  479.  
  480.   4. Open the convolves floating palette if it is not already open. Do
  481.      this by selecting `Show convolves' from the `Tools' menu.
  482.  
  483.   5. There should be 1 user convolve in the list - `Texture'. Click on
  484.      it.
  485.  
  486.   6. Apply the convolution filter to the image by clicking on `Apply'
  487.      at the bottom of the floating palette.
  488.  
  489.   7. After the filter has been applied, you could view the result with
  490.      the internal viewer in 24-bit, but for a clearer image we'll
  491.      convert it back to 32 colours.
  492.  
  493.   8. Open the colours requester, select `No. colours' = 32, `Colour
  494.      choice' = `Highest count' and `Dither' = `None'. Click on `OK'.
  495.  
  496.   9. Now view the 32 colour image with the internal viewer. The image
  497.      now has a rough paper(?) texture applied to it.
  498.  
  499.    Note:
  500.  
  501.    * There are many commonly used convolution filters available, it is
  502.      up to the user to build a collection suitable filters for their
  503.      own use. If you find any useful or interesting ones, you could
  504.      send them to the authors (see The authors) for inclusion into the
  505.      distribution.
  506.  
  507.    See Show convolves, for more information on the convolves floating
  508. palette.
  509.  
  510. Scaling the image
  511. =================
  512.  
  513.    In this example we will scale the `CheetahFace_250x200.ilbm' image
  514. from 250 x 200 pixels down to 80 x 40 (icon size).
  515.  
  516.   1. Load in the `CheetahFace_250x200.ilbm' image from the `Pics'
  517.      drawer.
  518.  
  519.   2. Open the scale requester by selecting `Scale...' in the `Process'
  520.      menu.
  521.  
  522.   3. Set the `Width' = 80 and `Height' = 40. Click on `OK'.
  523.  
  524.   4. The image is re-scaled to that of an icon.
  525.  
  526.    The finish the creation of the icon, we can load it into Commodore's
  527. `IconEdit' program. Both ImageStudio and IconEdit support the
  528. clipboard, so we can copy the image into the clipboard from ImageStudio
  529. and paste it into IconEdit.
  530.  
  531.   1. Copy the image to the clipboard by selected `Copy' in the `Edit'
  532.      menu of ImageStudio.
  533.  
  534.   2. Run IconEdit from the `Tools' drawer of your system partition.
  535.  
  536.   3. Select `Paste' from IconEdit's `Edit' menu. The image will be
  537.      copied into IconEdit for final editing.
  538.  
  539. Menu options
  540. ************
  541.  
  542.    This chapter describes ImageStudio's menu options in detail.
  543.  
  544.    Selecting a main menu from the list below will give a list of
  545. sub-menu options.
  546.  
  547. Project
  548. =======
  549.  
  550.    Select the submenu you wish to investigate.
  551.  
  552. Open
  553. ----
  554.  
  555.    Keyboard shortcut - `Amiga - O'
  556.  
  557.    This is how the user loads in an image into the program.
  558.  
  559.    A file requester will appear, through which the user can select a
  560. file to open. Upon selecting a file, ImageStudio will test the file
  561. against its known file formats - loading the file if the image type is
  562. recognised. If the image format is not recognised, an error will be
  563. shown.
  564.  
  565.    In most cases the image will load directly into ImageStudio; however
  566. in the case of HAM6 and HAM8 formats the image is converted into 24-bit
  567. data as it is loaded in, as ImageStudio cannot work directly on HAM
  568. images. For a detailed description of colour-mapped and 24-bit images,
  569. See Image types.
  570.  
  571. Save
  572. ----
  573.  
  574.    Keyboard shortcut - `Amiga - S'
  575.  
  576.    The save requester allows the user to choose the filename for the
  577. saved image as well as the image's format.
  578.  
  579.    To change the filename, either click in the string gadget and edit
  580. the filename directly or click on the `Choose...' gadget to select the
  581. filename with a file requester.
  582.  
  583.    To change the image format of the file to be saved, click in the
  584. listview on the appropriate format. Depending on the format selected,
  585. depends on whether the `Options...' and `Screen...' buttons remain
  586. unghosted. Some formats (e.g. IFF-ILBM) have further options available
  587. by clicking on the `Options...' button. The `Screen...' button can be
  588. clicked on to change the screenmode of the saved image (only used with
  589. IFF-ILBM images).
  590.  
  591.    When the user has selected the filename and the image format, the
  592. file can be saved by clicking on `OK' or no action can be performed by
  593. clicking on `Cancel'. If the currently selected filename already
  594. exists, the user will be warned that they are about to overwrite it.
  595.  
  596. Screen mode
  597. -----------
  598.  
  599.    The user may select the current screen's resolution and number of
  600. colours.
  601.  
  602.    The screenmode requester allows the user to change the properties of
  603. the current screen. Click on the desired screenmode as well as the
  604. size, number of colours and overscan settings. To bring the changes
  605. into effect, click on `OK' else to perform no action click on `Cancel'.
  606.  
  607.    See Known bugs, for information about a known problem with this
  608. operation.
  609.  
  610. Prefs
  611. -----
  612.  
  613.    This is how the user may configure the program to their own needs
  614. with the prefs requester.
  615.  
  616. Temp files
  617.      This is the drawer where ImageStudio will store its virtual memory
  618.      temporary files. By default, this is the `T:' drawer which usually
  619.      lies in the ram disk. Temp files kept in RAM will take up a lot of
  620.      memory, so it is recommended that they be moved out to somewhere
  621.      on hard disk. For example: using the Workbench, create a drawer
  622.      called `tmp' in the system partition of your hard drive. Then
  623.      change the temp files string in the prefs requester to `sys:tmp'.
  624.      ImageStudio will now store all its temporary files in this drawer.
  625.  
  626. Convolves
  627.      This is the drawer where ImageStudio will search for user-defined
  628.      convolution filters on startup. By default this is the `Convolves'
  629.      drawer in the same drawer as the program, but the user may change
  630.      this to an alternative location if they desire.
  631.  
  632. Palettes
  633.      This is the drawer where ImageStudio will search for extra palette
  634.      colour files when the palette requester is opened. By default this
  635.      is the `Palettes' drawer in the same drawer as the program, but
  636.      the user may change this to an alternative location if they desire.
  637.  
  638. Screen name
  639.      This is the name of the public screen on which ImageStudio is
  640.      running. By default this is `IMAGESTUDIO' but could be changed if
  641.      the user wishes to run 2 copies of the program on different
  642.      screens. Note: The new public screen name comes into effect either
  643.      when the program is restarted or if the user changes the
  644.      screenmode with the `Screen mode' requester (see Screen mode).
  645.  
  646. External viewer
  647.      This is the CLI command that ImageStudio will execute when the
  648.      user chooses `External viewer' from the `View' menu (see External
  649.      viewer). The string is in the form you would start the viewer from
  650.      a Shell or CLI, with a `%s' placed where the filename should be
  651.      placed.
  652.  
  653.      The default string of
  654.           run sys:Utilities/VT <NIL: >NIL: %s
  655.      would run Thomas Krehbiel's ViewTek program to view the image. If
  656.      you own one of the 3rd party 24-bit graphics cards supported by
  657.      ViewTek the image would be displayed on that.
  658.  
  659.      Note:
  660.  
  661.      It is not essential to start the program with `run', but this
  662.      allows ImageStudio to continue to run even with the viewer active.
  663.      The `<NIL: >NIL:' are also not essential, but will stop any text
  664.      output windows opening from the viewer.
  665.  
  666. Page size
  667.      This is the maximum amount (in kilobytes) of the virtual memory
  668.      temporary files to be loaded into RAM at any time. The larger you
  669.      make this value, the less disk accessing is performed but the more
  670.      data is transferred in a disk access. Use 50k for a minimal set
  671.      up, 100k for a more reasonable value.
  672.  
  673. Clip unit
  674.      This is the clipboard number to use. Set to 0 for normal use, any
  675.      number 1-255 if you wish to use a custom clipboard.
  676.  
  677. No. undo buffers
  678.      This is the maximum number of undo / redo steps possible. The
  679.      higher the number, to more disk space (not RAM) is used. Bear in
  680.      mind that when dealing with large 24-bit images each undo buffer
  681.      can be several megabytes - a value around 4 will suffice for most
  682.      users. Note: a change to this value will not come into effect
  683.      until the next time ImageStudio is run.
  684.  
  685. Save window positions
  686.      Check this box if you wish the current window layout to be the
  687.      default at startup.
  688.  
  689. Save screen mode
  690.      Check this box if you want the current screenmode to be the
  691.      default at startup.
  692.  
  693. Preview dither
  694.      When using a screen with few colours, checking this box enables
  695.      dithering to be used on the preview window to give the impression
  696.      of more colours. This slows down the preview redraw slightly.
  697.  
  698. Splash window
  699.      Checking this box causes the about requester to be shown at
  700.      startup.
  701.  
  702.    In order to save these preferences, click on `Save'. The information
  703. is written to the program's icon in the form of tooltypes; the user
  704. should have no need to alter these tooltypes directly.
  705.  
  706.    The current preferences can be used without saving by clicking on
  707. `Use' or ignored by clicking on `Cancel'.
  708.  
  709. Info
  710. ----
  711.  
  712.    This brings up an information requester containing memory and file
  713. usage information.
  714.  
  715.    The `Memory' figures are the amount of RAM used by the buffers, the
  716. `VMem' figures are the amount of disk space used by the virtual memory.
  717.  
  718.    At the bottom of the requester the amount of free RAM is shown.
  719.  
  720. About
  721. -----
  722.  
  723.    This brings up a small requester containing information about the
  724. program version number and the user name (only in registered version).
  725.  
  726. Quit
  727. ----
  728.  
  729.    This quits the program. If any changes remain unsaved, the user is
  730. warned before the program quits.
  731.  
  732. Edit
  733. ====
  734.  
  735.    Select the submenu you wish to investigate.
  736.  
  737. Undo
  738. ----
  739.  
  740.    Keyboard shortcut - `Amiga - U'
  741.  
  742.    Undos last operation.
  743.  
  744.    The maximum number of undos is set in the preferences requester, See
  745. Prefs.
  746.  
  747. Redo
  748. ----
  749.  
  750.    Keyboard shortcut - `Amiga - R'
  751.  
  752.    Redos last undo.
  753.  
  754.    The maximum number of redos is set in the preferences requester, See
  755. Prefs.
  756.  
  757. Copy
  758. ----
  759.  
  760.    Keyboard shortcut - `Amiga - C'
  761.  
  762.    Copies the current image to the clipboard.
  763.  
  764.    Once the image has been copied to the clipboard it can be used by
  765. any other program that supports the Amiga clipboard.
  766.  
  767. Paste
  768. -----
  769.  
  770.    Keyboard shortcut - `Amiga - V'
  771.  
  772.    Reads in image from the clipboard.
  773.  
  774. Region co-ords
  775. --------------
  776.  
  777.    Keyboard shortcut - `Amiga - D'
  778.  
  779.    Allows the user to select a region by typing the co-ordinates.
  780.  
  781.    The region co-ords requester allow the user to specify the selected
  782. region by either typing in the co-ordinates of the minimum and maximum
  783. corners of the rectangle or the minimum co-ordinates and the
  784. rectangle's width and height. A radio button on the left of the
  785. requester shows whether the maximum co-ords or the width and height are
  786. to be used to select the region.
  787.  
  788.    If there is already a selected region, these values are copied into
  789. the requester when it is opened.
  790.  
  791. Region deselect
  792. ---------------
  793.  
  794.    Removes any selected region from the preview window.
  795.  
  796.    As well as this menu item, the region can be cleared by simply
  797. clicking in the preview window.
  798.  
  799. Select all
  800. ----------
  801.  
  802.    Keyboard shortcut - `Amiga - A'
  803.  
  804.    Makes the selected region the whole of the displayed image in the
  805. preview window.
  806.  
  807.    Note:
  808.  
  809.    If the user has zoomed in on a region of the image (see Zoom in),
  810. `Select all' will not select the whole image but just the displayed
  811. image in the preview window.
  812.  
  813. View
  814. ====
  815.  
  816.    Select the submenu you wish to investigate.
  817.  
  818. Full image
  819. ----------
  820.  
  821.    Keyboard shortcut - `Amiga - F'
  822.  
  823.    Displays the whole image in the preview window.
  824.  
  825. Zoom in
  826. -------
  827.  
  828.    Keyboard shortcut - `Amiga - <'
  829.  
  830.    Zooms in to make the currently selected region fill the preview
  831. window.
  832.  
  833. Zoom out
  834. --------
  835.  
  836.    Keyboard shortcut - `Amiga - >'
  837.  
  838.    Zooms out by a factor of 3 times.
  839.  
  840. Internal viewer
  841. ---------------
  842.  
  843.    Keyboard shortcut - `Amiga - I'
  844.  
  845.    Views the current image with the internal viewer.
  846.  
  847.    If the image is colour-mapped, the viewer will try and open a screen
  848. with the same number of colours as the image. Under the AGA graphics
  849. chipset this should always be possible (providing there is enough free
  850. CHIP RAM), however under the ECS chipset it is impossible to open up
  851. screens of greater than 5 bitplanes. Viewing a 256 colour image, for
  852. example, on a ECS machine is not possible directly.
  853.  
  854.    If the image originated as an IFF-ILBM, the viewer screen will try
  855. and open up in the same screen mode as the image. If this is not
  856. possible, the user may change to a more suitable screenmode with the
  857. `View screenmode' menu option, See View screenmode.
  858.  
  859.    Viewing 24-bit images is done by using the HAM screenmodes (HAM6
  860. under ECS, HAM8 under AGA) to approximate the 24-bit image. In order to
  861. keep the viewer reasonably fast, the HAM image sometimes suffers from
  862. `colour fringing' as the approximation is relatively crude (especially
  863. under ECS).
  864.  
  865.    If the internal viewer won't display the current image, check the
  866. following:
  867.  
  868.   1. If the image was loaded in as an IFF-ILBM, the saved screenmode
  869.      may not be supported by your machine. For example, the screenmode
  870.      may be `Productivity' and your machine doesn't have a multiscan
  871.      monitor. Simply change the screenmode to one your machine does
  872.      support - e.g.  `Hires Laced'
  873.  
  874.   2. A colour-mapped image contains more colours than it is possible to
  875.      show on a ECS machine. Either reduce the number of colours in the
  876.      image to a number that can be displayed or increase the number of
  877.      colours to 16 million (see Colours) and use the internal viewer to
  878.      display an approximation in a HAM screen.
  879.  
  880.   3. Make sure you have enough CHIP RAM free to open the screen. Large
  881.      256 colour and 16 million colours images take lots of CHIP RAM.
  882.  
  883.    To stop the viewer at any time, press the right mouse button or
  884. click on `Abort' in the infobar.
  885.  
  886. View screenmode
  887. ---------------
  888.  
  889.    This allows the user to set the screenmode of the image, and
  890. therefore of the internal viewer.
  891.  
  892.    Click on the desired screenmode for the image in the screenmode
  893. requester. The current screenmode is highlighted in the listview.
  894.  
  895. External viewer
  896. ---------------
  897.  
  898.    Uses an external viewer program to view the image.
  899.  
  900.    This calls up the external viewer program to view the current image.
  901. If a 3rd party 24-bit graphics card is installed, a viewer can be used
  902. to view the image on that.
  903.  
  904.    To specify the external viewer to use, See Prefs.
  905.  
  906. Process
  907. =======
  908.  
  909.    Select the submenu you wish to investigate.
  910.  
  911. Crop
  912. ----
  913.  
  914.    Crops the current image to the selected region.
  915.  
  916.    This reduces the image to only that which is in the selected region.
  917. A region must be selected in order for this operation to work.
  918.  
  919. Scale
  920. -----
  921.  
  922.    Reduces / increases the size of the image.
  923.  
  924.    The scale requester allows the user to change the image's width /
  925. height by either selecting the absolute size of the new image or the
  926. percentage by which to scale. A radio gadget to the left shows which
  927. operation will be performed.
  928.  
  929.    The percentage value may also be changed by sliding the width and
  930. height sliders to achieve the desired final size; divide and multiply
  931. by 2 buttons are provided to quickly scale the image by common amounts.
  932.  
  933.    Finally, two methods of scaling are supported: fast and colour
  934. average. Fast scaling works with both colour-mapped and 24-bit images
  935. and produces results adequate for most needs. If the image is to be
  936. scaled up by a large amount the image may become very `blocky' and if
  937. the image is scaled down a large amount, information in the image may
  938. be lost. To reduce this, colour average scaling is available on 24-bit
  939. images which reduces blockiness when increasing the scale and reduces
  940. information loss when reducing the scale. Colour average rescale can
  941. take significantly longer than a fast rescale.
  942.  
  943. Colours
  944. -------
  945.  
  946.    Allows increasing / decreasing of the number of colours in the
  947. image, with various dithers.
  948.  
  949.    The colours requester allows the user control over the number of
  950. colours in the image. A radio button on the left hand side shows
  951. whether the current image is colour-mapped or 24-bit.
  952.  
  953.    To increase the number of colours in a colour-mapped image, simply
  954. select the new number of colours with the top cycle gadget or the `No.
  955. colours' slider. Although the number of colours need not be a power of
  956. 2 (2, 4, 8, 16, 32, 64, 128 or 256), internally the number will be
  957. rounded up to the nearest power of 2. If, for example, a 16 colour
  958. picture was increased to 20 colours then the image would become a 32
  959. colour image.
  960.  
  961.    Colour-mapped images can also be turned into 24-bit images by
  962. clicking on the `16 million colours' radio button on the left hand side
  963. of the requester. This is useful if the user wishes to perform an
  964. operation on a colour-mapped image that can only be performed on a
  965. 24-bit image. The resultant 24-bit image can then be turned back into a
  966. colour-mapped image after the operation is complete.
  967.  
  968.    To reduce the number of colours in an image, the same process is
  969. followed as above with a few differences. Whereas increasing the number
  970. of colours in an image does not lose any image information, it is
  971. enevitable that reducing the number of colours must lose some of the
  972. colour information. In order to help reduce the effect of this, two
  973. other aids are used: dithering and palette choice.
  974.  
  975.    The result of colour reduction is always a colour-mapped image. The
  976. user may select the number of colours in the final image with the top
  977. cycle gadget or the `No. colours' slider. Again, although the number of
  978. colours need not be a power of  2 (2, 4, 8, 16, 32, 64, 128 or 256),
  979. internally the number will be rounded up to the nearest power of 2.
  980. This though can be useful, as the user may want to reduce a 24-bit
  981. image down to 30 colours - leaving 2 spare for his / her own use.
  982.  
  983.    As part of the colour reduction process, ImageStudio has to pick a
  984. suitable palette for the resultant image. It does this by looking at
  985. the distribution of colours in the source image and choosing a palette
  986. by one of three methods: colour distance, heighest count or weighted
  987. average. The default, colour distance, is fine for most uses and works
  988. well with dithering. Heighest count is sometimes better for general
  989. images without dithering and weighted average is sometimes better for
  990. images containing many similar colours without dithering. There is no
  991. hard and fast rule which method of palette choice is best; if you're
  992. not happy with the result, try a different method.
  993.  
  994.    In order to give the impression of more colours in the reduced
  995. colour image, dithering can be employed to smoothly distribute colours
  996. over areas of high colour change. `Floyd-Steinberg' is the most common
  997. method and works well in most cases. For larger images, better contrast
  998. can be obtained by using a more computationally intensive dither
  999. (`Burkes', `Stucki', `Sierra', `Jarvis') and for the user with large
  1000. images and lots of time to spare, `Stevenson-Arce'. Again, there is no
  1001. hard and fast rule which method of dithering is best; if you're not
  1002. happy with the result, try a different method.
  1003.  
  1004. Palette
  1005. -------
  1006.  
  1007.    Allows the saving of the current palette and loading of new palette
  1008. onto the current image.
  1009.  
  1010.    Palettes can either be loaded or saved in ImageStudio:
  1011.  
  1012. Palette load
  1013.      This is used to force a palette onto an image. The requester
  1014.      allows the user to choose the palette to load and any dithering to
  1015.      be applied to the image, See Colours. Various sample palettes are
  1016.      given with the distribution to map the image to the Workbench
  1017.      colours or a general purpose palette. New palettes can be
  1018.      generated with any popular paint package(1).
  1019.  
  1020. Palette save
  1021.      Saves the current palette out to the filename chosen by the user
  1022.      in the requester. The palette file is compatible with the popular
  1023.      paint packages. This option has no relevance for 24-bit images, as
  1024.      they have no palette.
  1025.  
  1026.    ---------- Footnotes ----------
  1027.  
  1028.    (1)  Except Brilliance, which seems to save all 384 colours of its
  1029. palette.
  1030.  
  1031. Convolve presets
  1032. ----------------
  1033.  
  1034.    Various commonly used convolution effects.
  1035.  
  1036.    Convolution effects are a very powerful method of processing 24-bit
  1037. images. See below for more details on how they work.
  1038.  
  1039.    Some popular convolution effects are built in to ImageStudio:
  1040.  
  1041. Blur low
  1042.      Slightly blurs the image. The convolution matrix is:
  1043.           0  0  0  0  0
  1044.           0  0  1  0  0
  1045.           0  1  2  1  0
  1046.           0  0  1  0  0
  1047.           0  0  0  0  0
  1048.           Div = 6, Bias = 0
  1049.  
  1050. Blur high
  1051.      Blurs the image quite a lot. The convolution matrix is:
  1052.           0  1  1  1  0
  1053.           1  1  1  1  1
  1054.           1  1  1  1  1
  1055.           1  1  1  1  1
  1056.           0  1  1  1  0
  1057.           Div = 21, Bias = 0
  1058.  
  1059. Sharpen low
  1060.      Slightly sharpens the detail in the image. The convolution matrix
  1061.      is:
  1062.           0  0  0  0  0
  1063.           0  0 -1  0  0
  1064.           0 -1 10 -1  0
  1065.           0  0 -1  0  0
  1066.           0  0  0  0  0
  1067.           Div = 6, Bias = 0
  1068.  
  1069. Sharpen high
  1070.      Sharpens the detail in the image quite a lot. The convolution
  1071.      matrix is:
  1072.           0  0  0  0  0
  1073.           0 -2 -2 -2  0
  1074.           0 -2 18 -2  0
  1075.           0 -2 -2 -2  0
  1076.           0  0  0  0  0
  1077.           Div = 2, Bias = 0
  1078.  
  1079. Emboss low
  1080.      Gives the image a `lowered' look. The convolution matrix is:
  1081.           0  0  0  0  0
  1082.           0  0  0  0  0
  1083.           0  0  1  0  0
  1084.           0  0  0 -1  0
  1085.           0  0  0  0  0
  1086.           Div = 1, Bias = 204
  1087.  
  1088. Emboss high
  1089.      Gives the image a greater `lowered' look. The convolution matrix
  1090.      is:
  1091.           0  0  0  0  0
  1092.           0  0  0  0  0
  1093.           0  0  1  1  0
  1094.           0  0  1  0 -1
  1095.           0  0  0 -1 -1
  1096.           Div = 1, Bias = 204
  1097.  
  1098. Raise low
  1099.      Gives the image a `raised' look. The convolution matrix is:
  1100.           0  0  0  0  0
  1101.           0  0  0  0  0
  1102.           0  0  2  0  0
  1103.           0  0  0 -1  0
  1104.           0  0  0  0  0
  1105.           Div = 1, Bias = 0
  1106.  
  1107. Raise high
  1108.      Gives the image a greater `raised' look. The convolution matrix is:
  1109.           0  0  0  0  0
  1110.           0  0  0  0  0
  1111.           0  0  2  1  0
  1112.           0  0  1  0 -1
  1113.           0  0  0 -1 -2
  1114.           Div = 1, Bias = 0
  1115.  
  1116. Edge detect
  1117.      Replaces areas of high colour change to thin edges. The
  1118.      convolution matrix is:
  1119.           0  0  0  0  0
  1120.           0  0 -1  0  0
  1121.           0 -1  4 -1  0
  1122.           0  0 -1  0  0
  1123.           0  0  0  0  0
  1124.           Div = 1, Bias = 0
  1125.  
  1126.    What follows is a quick description of convolution, it is not
  1127. necessary to understand this to use the filters.
  1128.  
  1129.    It is convenient think of the convolution filter as an array of
  1130. numbers that "slides" over the image a pixel at a time. To find the new
  1131. colour value of the pixel at the centre of the filter, multiply the
  1132. filter values by the values of the colours under the array then divide
  1133. the result by the `Div' value, then add the `Bias' value.
  1134.  
  1135.    If we take the example of 3 x 3 `blur low' filter being applied to
  1136. the pixels below:
  1137.  
  1138.      filter                  pixels
  1139.      
  1140.      0 1 0                   a b c
  1141.      1 2 1  convolved with   d e f   gives:
  1142.      0 1 0                   g h i
  1143.  
  1144.    ((0 x a) + (1 x b) + (0 x c) + (1 x d) + (2 x e) + (1 x f) + (0 x g)
  1145. + (1 x h) + (0 x i)) / Div + Bias
  1146.  
  1147.    which would be applied to the new pixel in the position of the `e'
  1148. pixel.
  1149.  
  1150.    Although the pixels shown above are shown as `a', `b' etc... they
  1151. are actually the 3 red, green and blue values that comprise the colour.
  1152.  
  1153.    Examples:
  1154.  
  1155.   1.      0 0 0
  1156.           0 1 0
  1157.           0 0 0
  1158.           Div = 3, Bias = 0
  1159.      would make each pixel one third of its original brightness.
  1160.  
  1161.   2.      0 0 0
  1162.           0 0 0
  1163.           0 1 0
  1164.           Div = 1, Bias = 0
  1165.      would move each pixel up by one.
  1166.  
  1167.   3.      0 0 0
  1168.           0 1 0
  1169.           0 0 0
  1170.           Div = 1, Bias = 50
  1171.      would add 50 onto each of the red, green, blue components of the
  1172.      centre pixel.
  1173.  
  1174.    Note:
  1175.  
  1176.    * The red, green, blue components of a pixel can have values in the
  1177.      range 0 to 255. If a convolution value is greater than 255 it is
  1178.      made equal to 255. Similarly if a convolution value is less than 0
  1179.      it is made equal to 0.
  1180.  
  1181.    * ImageStudio has optimized routines for 1x1, 3x3 and 5x5 filters.
  1182.      If the program detects that only values in a 3x3 filter are being
  1183.      used, only calculations for a 3x3 filter are performed.
  1184.  
  1185. Tools
  1186. =====
  1187.  
  1188.    Select the submenu you wish to investigate.
  1189.  
  1190. Show balance
  1191. ------------
  1192.  
  1193.    Opens / closes the balance floating palette.
  1194.  
  1195.    The balance floating palette is used to control the brightness,
  1196. contrast and gamma of the current image. On 24-bit images, the colour
  1197. balance can be altered on selected regions as well as the whole image
  1198. whereas colour-mapped images only allow alterations to the whole image.
  1199.  
  1200.    The colour balance effects are usually applied to all the red /
  1201. green / blue components simultaneously, but each component can be
  1202. altered individually by checking the `Red', `Green' or `Blue'
  1203. checkboxes at the bottom of the floating palette.
  1204.  
  1205.    The effect of changing either the brightness, contrast or gamma can
  1206. be seen in the graph on the right hand side of the floating palette.
  1207. The graph shows the input RGB component along the X-axis and the output
  1208. RGB component along the Y-axis.
  1209.  
  1210.               output
  1211.       Light RGB ^
  1212.                 |
  1213.                 |
  1214.                 |
  1215.                 |
  1216.                 |
  1217.        Dark RGB |
  1218.                 +-------> input
  1219.             Dark RGB  Light RGB
  1220.  
  1221.    No operation is shown therefore with a straight diagonal line - the
  1222. input value is mapped to the same output value.
  1223.  
  1224.               output
  1225.                 ^
  1226.                 |     /
  1227.                x|____/
  1228.                 |   /|
  1229.                 |  / |
  1230.                 | /  |
  1231.                 |/   |
  1232.                 +-------> input
  1233.                      x
  1234.  
  1235. Brightness
  1236.      Altering the brightness is achieved by mutliplying up / down the
  1237.      RGB components by the specified amount. The range of the slider is
  1238.      from -100% (everything becomes black) to +100% (everything is
  1239.      twice as bright).
  1240.  
  1241. Contrast
  1242.      Altering the contrast forces dark colours darker and light colours
  1243.      lighter. The range of the slider is from -100% (everything becomes
  1244.      mid grey) to +100% (RGB components are either on/off).
  1245.  
  1246.      Note: 100% contrast on a colour image doesn't produce a black and
  1247.      white image as may be expected. As each RGB component is treated
  1248.      individually, it leaves you with an 8 colour image - the 8 colours
  1249.      being composed of combinations of the RGB components as below:
  1250.  
  1251.     Black
  1252.           0% Red, 0% Green, 0% Blue
  1253.  
  1254.     Red
  1255.           100% Red, 0% Green, 0% Blue
  1256.  
  1257.     Green
  1258.           0% Red, 100% Green, 0% Blue
  1259.  
  1260.     Blue
  1261.           0% Red, 0% Green, 100% Blue
  1262.  
  1263.     Yellow
  1264.           100% Red, 100% Green, 0% Blue
  1265.  
  1266.     Magenta
  1267.           100% Red, 0% Green, 100% Blue
  1268.  
  1269.     Cyan
  1270.           0% Red, 100% Green, 100% Blue
  1271.  
  1272.     White
  1273.           100% Red, 100% Green, 100% Blue
  1274.  
  1275.      If you wish to turn a colour image into 2 colour black and white,
  1276.      greyscale the image first with the greyscale effect, See Show
  1277.      effects.
  1278.  
  1279. Gamma
  1280.      Adjusting the gamma of an image has the effect of lightening some
  1281.      of the mid-dark colours, whilst leaving the dark colours dark.
  1282.      This can often enhance the eye's perception of the image, as the
  1283.      eye is more responsive to light colours. Gamma correction can also
  1284.      be useful when printing an image out, as mid-dark colours tend to
  1285.      get printed too dark.
  1286.  
  1287.      Only small alterations are usually needed with this operator (-20%
  1288.      to +20%).
  1289.  
  1290. Show effects
  1291. ------------
  1292.  
  1293.    Opens / closes the effects floating palette.
  1294.  
  1295.    The effects floating palette contains a list of ImageStudio's built
  1296. in effects. Not all types of effect can be applied to all types of
  1297. buffer, the details are given below. Any numerical values required by
  1298. the individual effects are set using the slider on the effect floating
  1299. palette.
  1300.  
  1301. FlipX
  1302.      Can be applied to all types of image.  Flips the whole image or
  1303.      selected region horizontally.
  1304.  
  1305. FlipY
  1306.      Can be applied to all types of image.  Flips the whole image or
  1307.      selected region vertically.
  1308.  
  1309. RollX
  1310.      Can be applied to all types of image.  Rolls the whole image or
  1311.      selected region horizontally, wrapping the image around.
  1312.  
  1313. RollY
  1314.      Can be applied to all types of image.  Rolls the whole image or
  1315.      selected region vertically, wrapping the image around.
  1316.  
  1317. Negative
  1318.      Cannot be applied to regions of a colour-mapped images.  Negates
  1319.      the colour values of the image.
  1320.  
  1321. Greyscale
  1322.      Cannot be applied to regions of a colour-mapped images.  Reduces a
  1323.      colour image to a greyscale image. The actual greyscale values (or
  1324.      more correctly, luminosity) value is calculated as 30% of the red
  1325.      component + 59% of the green component + 11% of the blue component.
  1326.  
  1327. Highlight
  1328.      Cannot be applied to regions of a colour-mapped images.  Turns all
  1329.      colours with greater than the given luminance value to white.
  1330.  
  1331. Shadow
  1332.      Cannot be applied to regions of a colour-mapped images.  Turns all
  1333.      colours with less than the given luminance value to black.
  1334.  
  1335. Random
  1336.      Cannot be applied to colour-mapped images.  Adds random noise to
  1337.      the image. The greater the random value, the greater the noise.
  1338.  
  1339. Pixelize
  1340.      Can be applied to all types of image.  Replaces all pixels in the
  1341.      whole image or selected region with larger pixels. The new pixel
  1342.      size is taken from the slider.
  1343.  
  1344. Remove isolated pixels
  1345.      Can be applied to all types of image.  Removes any single pixels
  1346.      that are a different colour to their neighbours. Useful in
  1347.      removing some of the noise in black and white scans.
  1348.  
  1349. Show convolves
  1350. --------------
  1351.  
  1352.    Opens / closes the convolves floating palette.
  1353.  
  1354.    The convolves floating palette allows the user to apply their own
  1355. convolution effects to a 24-bit image; convolution will not work on
  1356. colour-mapped images. For an explanation of how convolution works, See
  1357. Convolve presets.
  1358.  
  1359.    To create a new convolution filter, select `New' and then `Edit'
  1360. from the floating palette. The convolve grid requester contains the
  1361. convolution filter's name at the top as well as gadgets for the filter,
  1362. divisor and bias values. When the user has set the filter values, click
  1363. on `OK' to return to the convolve floating palette.
  1364.  
  1365.    To apply a filter, select it in the listview and click on `Apply'.
  1366. To delete a filter from the list, click on `Del'. This will not delete
  1367. the file from the disk, this has to be done from the Workbench.
  1368.  
  1369.    To scan a new drawer for convolution filters, click on `Load' and
  1370. select a directory to scan. To save the current list's convolution
  1371. filters, click on `Save' and select a drawer to save to.
  1372.  
  1373.    The default drawer to scan at startup is set in the preferences, See
  1374. Prefs.
  1375.  
  1376. Reference
  1377. *********
  1378.  
  1379.    This chapter gives detailed explanations about various aspects of
  1380. the program.
  1381.  
  1382. File formats
  1383. ============
  1384.  
  1385.    Select the file format you wish to investigate.
  1386.  
  1387. IFF-ILBM
  1388. --------
  1389.  
  1390.    IFF-ILBM is the Amiga's native bitmap graphic file format.
  1391.  
  1392.    IFF-ILBM covers both colour-mapped (palette based) images, true
  1393. 24-bit and hold-and-modify (HAM8) colour modes.
  1394.  
  1395.    IFF-ILBM files are usually compressed using simple run-length
  1396. compression, but they can be uncompressed for simplicity and speed.
  1397.  
  1398. Loads:
  1399.         - Compressed (cmpByteRun) and uncompressed IFF-ILBM files.
  1400.  
  1401.         - Colour-mapped (palette based) images upto 256 colours.
  1402.  
  1403.         - HAM6 and HAM8 images.
  1404.  
  1405.         - Extra half-bright images.
  1406.  
  1407.         - ILBM24 24-bit images.
  1408.  
  1409. Saves:
  1410.         - Compressed (cmpByteRun) and uncompressed IFF-ILBM files.
  1411.  
  1412.         - Colour-mapped (palette based) images upto 256 colours.
  1413.  
  1414.         - HAM6 and HAM8 images.
  1415.  
  1416.         - Extra half-bright images.
  1417.  
  1418.         - ILBM24 24-bit images.
  1419.  
  1420.    Note:
  1421.  
  1422.    * ImageStudio will load and save AGA images on a non-AGA machine.
  1423.  
  1424.    * The original image's screenmode will be preserved, unless changed
  1425.      by the user (see View screenmode).
  1426.  
  1427. BMP
  1428. ---
  1429.  
  1430.    BMP files are commonly found on PCs running Microsoft Windows.
  1431.  
  1432.    BMP images can be both colour-mapped (palette based) or true 24-bit
  1433. colour.
  1434.  
  1435.    BMP images are usually uncompressed and come in 2 flavours -
  1436. `Windows' and `OS/2'.
  1437.  
  1438. Loads:
  1439.         - Windows and OS/2 formatted uncompressed images.
  1440.  
  1441.         - Colour-mapped (palette based) images upto 256 colours.
  1442.  
  1443.         - 24-bit colour images.
  1444.  
  1445. Saves:
  1446.         - Windows formatted uncompressed images.
  1447.  
  1448.         - Colour-mapped (palette based) images upto 256 colours.
  1449.  
  1450.         - 24-bit colour images.
  1451.  
  1452. GIF
  1453. ---
  1454.  
  1455.    GIF is a common format for images upto 256 colours.
  1456.  
  1457.    GIF is a trademark of Compuserve Incorporated.
  1458.  
  1459.    GIF images are normally smaller than their equivalent IFF-ILBM
  1460. counterparts due to GIF's LZW compression algorithm. GIF files are
  1461. always compressed.
  1462.  
  1463.    GIF comes in 2 flavours - `GIF87a' and `GIF89a'. GIF87a is the most
  1464. popular format; ImageStudio should load in both GIF87a and GIF89a
  1465. although the latter is untested as we couldn't find any genuine GIF89a
  1466. files.
  1467.  
  1468. Loads:
  1469.         - GIF87a and GIF89a (see above) format images.
  1470.  
  1471.         - Colour-mapped (palette based) images upto 256 colours.
  1472.  
  1473. Saves:
  1474.         - GIF87a format images.
  1475.  
  1476.         - Colour-mapped (palette based) images upto 256 colours.
  1477.  
  1478. JPEG
  1479. ----
  1480.  
  1481.    JPEG is a powerful format for storing images as 24-bits.
  1482.  
  1483.    JPEG allows the storage of 24-bit images as very small files due to
  1484. its lossy compression algorithm. Whereas the compression algorithms
  1485. used by other file formats loose none of the image information, JPEG
  1486. trades off a little loss in image quality for a high degree of
  1487. compression.
  1488.  
  1489.    In order to select the degree of image quality, select the `Options
  1490. choose' from the `Save' requester (see Save). A quality value of 75 is
  1491. given by default, resulting in an acceptable degredation of image
  1492. quality. For higher degree of compression choose a lower value(1). For
  1493. a higher degree of quality, choose a higher value; values of 85 to 90
  1494. result in an almost unnoticable loss of quality.
  1495.  
  1496. Loads:
  1497.         - JPEG / JFIF format images.
  1498.  
  1499.         - 24-bit images.
  1500.  
  1501. Saves:
  1502.         - JPEG / JFIF format images.
  1503.  
  1504.         - Colour-mapped and 24-bit images.
  1505.  
  1506.    As JPEG is a relatively new format, an exact format of the JPEG file
  1507. was only agreed on recently. This format is called `JFIF' and these are
  1508. the most commonly used JPEG format files - and the format that
  1509. ImageStudio loads and saves. It is highly unlikely that any old JPEG
  1510. files are still being circulated, but should you find one it is
  1511. uncertain whether ImageStudio would accept it.
  1512.  
  1513.    A high degree of compatibility is obtained with our JPEG loader /
  1514. saver routines, as they are based in part on the work of the
  1515. Independant JPEG group's routines.
  1516.  
  1517.    ---------- Footnotes ----------
  1518.  
  1519.    (1)  Values less than 25 may cause problems with some JPEG readers
  1520.  
  1521. PCX
  1522. ---
  1523.  
  1524.    PCX files are commonly found on PCs running Microsoft Windows.
  1525.  
  1526.    PCX images can be both colour-mapped (palette based) or true 24-bit
  1527. colour. PCX files are always compressed using a very inefficient
  1528. run-length encoding algorithm. This algorithm can, in some cases, lead
  1529. to an increase in file size over an uncompressed image. PCX is included
  1530. in ImageStudio for compatibility with other platforms, but we do not
  1531. recommend the general storing of images in this format.
  1532.  
  1533. Loads:
  1534.         - Colour-mapped (palette based) images with 2 - 16 colours.
  1535.  
  1536.         - Colour-mapped (palette based) with 256 colours.
  1537.  
  1538.         - 24-bit colour images.
  1539.  
  1540. Saves:
  1541.         - Colour-mapped (palette based) with 256 colours.
  1542.  
  1543.         - 24-bit colour images.
  1544.  
  1545. Targa
  1546. -----
  1547.  
  1548.    Targa is an established colour-mapped and 24-bit colour format used
  1549. on the PC.
  1550.  
  1551.    Targa is usually used for storing 24-bit images, although it can
  1552. also handle colour-mapped images as well. The data is usually stored as
  1553. simple uncompressed data, however it can also be run-length encoded to
  1554. allow compression.
  1555.  
  1556. Loads:
  1557.         - Uncompressed / compressed Targa format.
  1558.  
  1559.         - Colour-mapped (2 colour, 256 colour).
  1560.  
  1561.         - 15, 16, 24 and 32-bit true colour images.
  1562.  
  1563. Saves:
  1564.         - Uncompressed Targa format.
  1565.  
  1566.         - 256 colour-mapped images.
  1567.  
  1568.         - 24-bit colour images.
  1569.  
  1570. Image types
  1571. ===========
  1572.  
  1573.    ImageStudio works internally with either "colour-mapped" or "24-bit"
  1574. images. A description of the workings of both methods follows.
  1575.  
  1576. Colour-mapped images
  1577.      Colour-mapped (palette based) images are used by the standard
  1578.      (non-HAM) screenmodes on the Amiga. A set of colours (palette) is
  1579.      chosen for the image and every pixel in the image can have one of
  1580.      these colours.
  1581.  
  1582.      Colour-mapped images have the advantage of being a fairly compact
  1583.      way of storing image information and with a large palette (greater
  1584.      than 64 colours) high quality images can be produced. They have
  1585.      the disadvantage that the colours in the image are limited to the
  1586.      colours in the palette - with a small palette it becomes a complex
  1587.      task choosing the correct colours to best portray the image.
  1588.  
  1589. 24-bit images
  1590.      24-bit images allow every pixel in the image to be an individual
  1591.      colour - this is essential for high quality images.
  1592.  
  1593.      24-bit images have the disadvantage that they are typically at
  1594.      least 3-times larger than colour-mapped images and require
  1595.      sophisticated display hardware to show them in their true glory.
  1596.  
  1597. When should I use each type of image?
  1598.      In general, try to leave the image in the format in which it came.
  1599.      If, for example, you load in a colour-mapped image try and perform
  1600.      all your operations directly to the colour-mapped image; only
  1601.      change to a 24-bit image if absolutely necessary (e.g. to apply a
  1602.      convolution filter).
  1603.  
  1604. Tooltypes
  1605. =========
  1606.  
  1607.    ImageStudio supports the configuring of the program via tooltypes
  1608. from either the Workbench or CLI.
  1609.  
  1610.    It is recommended that the user who starts the program from
  1611. Workbench uses the "Prefs" requester of ImageStudio to configure it
  1612. (see Prefs), whereas the CLI user should be aware of the tooltype
  1613. options.
  1614.  
  1615.    Possible options for a tooltype value are shown with a bar `|'
  1616. character (read as `or'). Numerical values are shown as `<value>',
  1617. string values as `<string>'.
  1618.  
  1619. `CONVOLVE=YES | NO'
  1620.      Whether the convolve floating palette should be open at startup.
  1621.  
  1622. `CONVOLVETOP=<value>'
  1623.      The top position to open the convolve floating palette.
  1624.  
  1625. `CONVOLVELEFT=<value>'
  1626.      The left position to open the convolve floating palette.
  1627.  
  1628. `EFFECT=YES | NO'
  1629.      Whether the effect floating palette should be open at startup.
  1630.  
  1631. `EFFECTTOP=<value>'
  1632.      The top position to open the effect floating palette.
  1633.  
  1634. `EFFECTLEFT=<value>'
  1635.      The left position to open the effect floating palette.
  1636.  
  1637. `BALANCE=YES | NO'
  1638.      Whether the balance floating palette should be open at startup.
  1639.  
  1640. `BALANCETOP=<value>'
  1641.      The top position to open the balance floating palette.
  1642.  
  1643. `BALANCELEFT=<value>'
  1644.      The left position to open the balance floating palette.
  1645.  
  1646. `PREVIEWTOP=<value>'
  1647.      The top position to open the preview window.
  1648.  
  1649. `PREVIEWLEFT=<value>'
  1650.      The left position to open the preview window.
  1651.  
  1652. `PREVIEWWIDTH=<value>'
  1653.      The width of the preview window.
  1654.  
  1655. `PREVIEWHEIGHT=<value>'
  1656.      The height of the preview window.
  1657.  
  1658. `SCREENMODEID=<value>'
  1659.      The screenmode to open the ImageStudio screen.
  1660.  
  1661. `SCREENOVERSCAN=TEXT | STANDARD | MAX | VIDEO'
  1662.      The overscan to be used on the ImageStudio screen.
  1663.  
  1664. `SCREENDEPTH=<value>'
  1665.      The depth in bitplanes of the ImageStudio screen.
  1666.  
  1667. `TEMPDIR=<string>'
  1668.      The location on hard disk to store the virtual memory temporary
  1669.      files.
  1670.  
  1671. `CONVOLVEDIR=<string>'
  1672.      The drawer to read for the covolution filters.
  1673.  
  1674. `PALETTEDIR=<string>'
  1675.      The drawer to read for palettes.
  1676.  
  1677. `PAGESIZE=<value>'
  1678.      The size, in kilobytes, of the virtul memory pages.
  1679.  
  1680. `CLIPUNIT=<value>'
  1681.      The system clipboard unit to use.
  1682.  
  1683. `EXTERNALVIEWER=<string>'
  1684.      The CLI command to execute to run the external 24-bit viewer.
  1685.  
  1686. `UNDOBUFFERS=<value>'
  1687.      The number of levels of undo / redo available.
  1688.  
  1689. `PREVIEWDITHER=YES | NO'
  1690.      Whether to perform dithering on the greyscale preview window.
  1691.  
  1692. `SPLASHWINDOW=YES | NO'
  1693.      Whether to open the `About' window at startup.
  1694.  
  1695. Known bugs
  1696. ==========
  1697.  
  1698.    Known bugs:
  1699.  
  1700.    * When changing the screenmode of the ImageStudio program (see
  1701.      Screen mode), the menus are not properly laid out for 2-colour
  1702.      modes. We don't know the reason why, as we re-layout the menus
  1703.      after changing the screenmode. The menus are correctly laid out if
  1704.      the program is started in a 2-colour mode.
  1705.  
  1706.    * At the moment ImageStudio doesn't handle IFF-ILBM files with an
  1707.      interleaved stencil. Make sure when saving from an paint package
  1708.      that the stencil is turned off.
  1709.  
  1710. Problems with datatypes
  1711. =======================
  1712.  
  1713.    If ImageStudio is running on a Workbench 2.1+ Amiga it will utilise
  1714. the built in datatypes for image conversion; the user should be made
  1715. aware of differences between the datatypes and the built-in ImageStudio
  1716. loaders.
  1717.  
  1718.    The datatypes are only used as a "last resort" if the ImageStudio
  1719. loaders fail to recognise the incoming image. Datatypes have the
  1720. following disadvantages:
  1721.  
  1722.    * The do not utilize virtual memory. Therefore when loading a large
  1723.      image, large amounts of RAM are required.
  1724.  
  1725.    * They can be slow. The datatype first has to convert the image to
  1726.      IFF-ILBM, which ImageStudio has to read in and convert to its own
  1727.      internal format.
  1728.  
  1729.    * Datatypes convert the image to a colour-mapped image. 24-bit image
  1730.      formats (e.g. JPEG) therefore are reduced in quality.
  1731.  
  1732.    * Some datatypes we have tried are fundementally bugged - crashing
  1733.      with odd sized images or different file layouts. ImageStudio has
  1734.      no control over the quality of the installed datatypes.
  1735.  
  1736.    Datatypes though can be useful to load in image formats not yet
  1737. supported by ImageStudio, and are therefore made available to the user.
  1738.  
  1739. Common questions
  1740. ****************
  1741.  
  1742.    If you have any questions about ImageStudio, make sure that it
  1743. hasn't already been answered below:
  1744.  
  1745. Why doesn't ImageStudio support the TIFF image format?
  1746.      TIFF is a powerful and flexible image format, but that is also its
  1747.      downfall. TIFF supports so many compression algorithms, for
  1748.      example, that it would require a very large amount of code to deal
  1749.      with even a modest range of TIFF files.
  1750.  
  1751.      TIFF could well get added later if the loader / savers become
  1752.      external modules, but there is more important work to be done in
  1753.      the meantime.
  1754.  
  1755. Can I turn virtual memory off?
  1756.      ImageStudio will always work with virtual memory. If you are lucky
  1757.      enough to have lots of RAM and you wish to use that instead of
  1758.      your hard disk, simply put the temp. files in the ram disk (see
  1759.      Prefs). The overhead of using virtual memory from RAM is
  1760.      negligible.
  1761.  
  1762. Why does the program crash if I start it from a CLI?
  1763.      Your stack is probably too small, See Starting ImageStudio.
  1764.  
  1765. Why do sometimes operations stop unexpectadly with no error?
  1766.      This is most likely a low memory condition, as ImageStudio is
  1767.      highly error-trapped and will always give an error where possible.
  1768.      In very low memory conditions (*very* low memory) it was decided
  1769.      that even trying to open a requester to tell you that you were
  1770.      short of memory would take too much memory - so it fails quietly.
  1771.  
  1772. The authors
  1773. ***********
  1774.  
  1775.    ImageStudio was written by Andy Dean and Graham Dean.
  1776.  
  1777.    Queries and orders (see How to register) should be sent to Graham at:
  1778.  
  1779.      Graham Dean,
  1780.      14 Fielding Avenue,
  1781.      Poynton,
  1782.      Stockport,
  1783.      Cheshire.
  1784.      SK12 1YX
  1785.      ENGLAND
  1786.  
  1787.    Andy can be reached for queries (no orders) via Internet Email at:
  1788.  
  1789.      adean@eleceng.ucl.ac.uk
  1790.  
  1791.    The rate at which ImageStudio progresses depends on a few things:
  1792.  
  1793.   1. You. If you like and use the program, please register it. If you
  1794.      like the program but think it is missing something that isn't
  1795.      already in our future additions list (see Future additions) *let
  1796.      us know!*.
  1797.  
  1798.   2. Other work. Graham is studying `A' levels and Andy is doing a PhD
  1799.      and this work will take priority (sad, but true).
  1800.  
  1801.    If you find a bug in ImageStudio that is not convered in the `Known
  1802. bugs' list (see Known bugs), inform the authors at the above addresses.
  1803. Be sure to include as much information as possible, the version of
  1804. ImageStudio being used, a description of the Amiga system you are
  1805. running (model, amount of RAM, Workbench version, any expansion cards).
  1806.  
  1807.    If you are having problems loading a particular file into
  1808. ImageStudio, test whether it will load into any another package and if
  1809. possible whether other files created by the same program also give
  1810. problems. We cannot really test every faulty file, but if files created
  1811. by one particular program only give problems on ImageStudio then we'll
  1812. look into that.
  1813.  
  1814. How to register
  1815. ***************
  1816.  
  1817.    To receive the full version of ImageStudio, send 10 pounds sterling
  1818. (20 US dollars overseas) to:
  1819.  
  1820.      Graham Dean,
  1821.      14 Fielding Avenue,
  1822.      Poynton,
  1823.      Stockport,
  1824.      Cheshire.
  1825.      SK12 1YX
  1826.      ENGLAND
  1827.  
  1828.    In return you will receive the full version of the package, complete
  1829. with a 68020+ optimized version of the code for faster convolution and
  1830. dithering. Please allow a resonable time to allow cheque clearance,
  1831. etc...
  1832.  
  1833.    Upgrades will be offered to registered users free of charge. Simply
  1834. send a self-addressed-envelope and a disk to the above address and you
  1835. will receive the latest version (it's probably best to contact us first
  1836. to find out what the latest version is).
  1837.  
  1838.    The version number of ImageStudio (see About) is to be interpreted
  1839. as:
  1840.  
  1841.      version.revision.subrevision
  1842.  
  1843.    The `version' shows the main version of the program, `revision' will
  1844. be increased as small additions and improvements are made to the
  1845. program. The `subdivision' value is incremented with bug fixes. All the
  1846. values are simple decimal, not floating point, so version 1.9.0 would
  1847. be followed by version 1.10.0.
  1848.  
  1849.    New versions of the unregistered package will be distributed with
  1850. every change in revision number.
  1851.  
  1852. Credits
  1853. *******
  1854.  
  1855.    The authors would like to thank:
  1856.  
  1857.    * Commodore-Amiga.
  1858.  
  1859.    * Carl Revell and David Cusick, for beta testing ImageStudio.
  1860.  
  1861.    * Matt Dillon, for the `Dice' C compiler.
  1862.  
  1863.    * Ian OConner, for `The Designer' - used to do all the GUI windows
  1864.      design.
  1865.  
  1866.    * All the public domain / freeware / shareware authors, for loads of
  1867.      great software.
  1868.  
  1869.    * The Independant JPEG Group, for their essential JPEG code and
  1870.      information.
  1871.  
  1872.    * All those involved with the excellent TeX and `TeXinfo' packages.
  1873.  
  1874.    ImageStudio has been tested on:
  1875.  
  1876.    - A500, Workbench 2.04, 1Mbyte CHIP RAM, 2Mbyte FAST RAM, A590
  1877.      85Mbyte SCSI hard drive, Microbotics VXL*30 accelerator (no 32-bit
  1878.      RAM).
  1879.  
  1880.    - A1200, Workbench 3.0, 2Mbyte CHIP RAM, 4MByte FAST RAM, Power
  1881.      PC1204 expansion card, 68882 FPU, 85Mbyte IDE hard drive.
  1882.  
  1883.    - A4000/EC030, Workbench 3.0, 2Mbyte CHIP RAM, 4MByte FAST RAM,
  1884.      68882 FPU, 130Mbyte IDE hard drive.
  1885.  
  1886. Future additions
  1887. ****************
  1888.  
  1889.    The following features will probably be added to future versions of
  1890. the packages (roughly in order):
  1891.  
  1892.    * Encapsulated PostScript (EPS) file save.
  1893.  
  1894.    * Halftoning operators.
  1895.  
  1896.    * Improved palette handling.
  1897.  
  1898.    * Spare buffer.
  1899.  
  1900.    * Alpha channel buffer.
  1901.  
  1902.    * Making the loader / savers external modules.
  1903.  
  1904.    * ARexx.
  1905.  
  1906.    * Aspect ratio correction in the preview window.
  1907.  
  1908.    * AmigaGuide help from the program.
  1909.  
  1910.